home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / EDITOR / PCTCO253.ARJ / README.1ST < prev    next >
Text File  |  1992-06-22  |  9KB  |  269 lines
  1.                            HOW TO SETUP TECO
  2.  
  3.     TECO is an old editor and not well suited to today's environment
  4.     yet there are things you can do with TECO that you can do with
  5.     no other editor (or only with great difficulty). With the function
  6.         key enhancements described below and a good macro library TECO becomes
  7.     very usable. Some of the things that set TECO apart are its ability
  8.     to edit any size file, do complicated repetitions (n<cmd...>), use of
  9.     regular expressions and conditional execution.
  10.  
  11.     I've found the best way to set up TECO is to put TECO.EXE in my
  12.     utility directory (which is in my path) and put all the indirect
  13.     files (.TEC), including TECO.INI, in a separate directory say \TEC
  14.         and put the following in the autoexec.bat file:
  15.  
  16.     APPEND /E
  17.     APPEND C:\TEC
  18.  
  19.     This allows TECO to find the indirect files no matter what the current
  20.     directory. If you want to edit a .TEC set up this way it is best to
  21.     cd \TEC first since TECO won't know where to write the changed file
  22.     (the MSDOS APPEND command is only good for reading).
  23.  
  24. ** Note: Not documented elsewhere is the fact that you can get a printout
  25.          of the file you're editing with EWprn$EC$$. Also, if you just want
  26.          a printout of the text buffer you might try EWprn$PWEF$$. You need
  27.          the EF to flush PCTECO's internal file buffer. Note that many 
  28.          *text* editors append a ^Z when closing the file, if you do not
  29.          delete this ^Z the device output commands will choke since they are
  30.          text file devices. Teco could care less about ^Z and does not append
  31.          one. 
  32.  
  33.          Also mentioned no where else is the fact that one can enter 
  34.          characters between 128-255 into the text buffer with the ALT-ddd
  35.          sequence. 
  36.  
  37.      In this package you will find:
  38.  
  39.           README.1ST         ! this file !
  40.           BETA.DOC           ! defunct beta instructions !
  41.           TECO.EXE           ! the executable written in TP 5.5 !
  42.           TECO.INI           ! startup macro file !
  43.           MAKE.BAT           ! batch file for the make function !
  44.           MUNG.BAT           ! batch file for the mung function !
  45.           FLAGS.DOC          ! documentation of TECO flags !
  46.           COMMANDS.DOC       ! documentation of TECO commands !
  47.           REVISION.DOC       ! revision history !
  48.  
  49. TECO.EXE
  50.  
  51.     The simplified command line for TECO is
  52.  
  53.            TECO [ [ filespec1 [ filespec2 ] ] | @filespec1 ]
  54.  
  55. On startup TECO executes the following
  56.  
  57.            :ERTECO.INI$"S Y HXW HK MW HXW$$
  58.  
  59. which reads your TECO.INI init macro into the text buffer, if present, puts
  60. it into q-register W and executes it (mw) and releases the macro space (hxw).
  61.  
  62. Also on startup TECO loads the Text Buffer with a macro to parse your command
  63. line, puts your command line in the FileSpec Register and then loads into
  64. the Command Buffer and executes the following
  65.  
  66.            HXY HKG* HXZ HK :EITECO$$
  67.  
  68. This puts the command line parsing macro in Q-register Y (HXY), clears the
  69. Text Buffer (HK), puts the contents of the FileSpec Register into the Text
  70. Buffer (G*), copies the Text Buffer into Q-register Z (HXZ), clears the
  71. Text Buffer (HK) and then executes, as an Indirect File, TECO.TEC if present
  72. in the default directory. It then executes MY$$ which parses your command
  73. line (if not null) which opens all requested files. (All $ symbols represent
  74. <ESC>, of course). For example, if you just type (at the DOS prompt)
  75.  
  76.                 >TECO
  77.  
  78. it starts with no files open and you must explicitly use the EW, etc command
  79. to save anything you enter with the I or ^I command. Or you could use the
  80. ER and Y command to read in a file, modify it and then use the EW command
  81. to save it. (With an EX or EC, of course).
  82.  
  83. Typing
  84.  
  85.                 >TECO filespec1
  86.  
  87. is equivalent to typing at the DOS prompt
  88.  
  89.                 >TECO
  90.                 *EBfilespec1$Y$$
  91.  
  92. (the * is TECO's prompt).
  93.  
  94. If you type
  95.  
  96.                 >TECO filespec1 filespec2
  97.  
  98. you get
  99.  
  100.                 >TECO
  101.                 *ERfilespec1$EWfilespec2$Y$$
  102.  
  103. on the other hand
  104.  
  105.                 >TECO @filespec1
  106.  
  107. is equivalent to
  108.  
  109.                 >TECO
  110.                 *EIfilespec1$$
  111.  
  112. TECO.TEC
  113.  
  114.      The EI command is used to run indirect files as commands. If the file
  115. has the extension [.TEC] it need not be specified in the EI command so
  116. the TECO.TEC file would be run by
  117.  
  118.                 *EIteco$$
  119.  
  120. except that this is a default name and is run automagically at startup.
  121. Remember, the EI command does not start execution of the the named file,
  122. the double <ESC> does. So if your EI command is not at the end of a macro
  123. the sequencing you were expecting may not occur. No TECO.TEC file is supplied
  124. with this version of PCTECO.
  125.  
  126. OTHER WAYS TO START TECO
  127.  
  128. MAKE.BAT
  129.  
  130.      If you type
  131.  
  132.                 >MAKE filespec1
  133.  
  134. this is equivalent to
  135.  
  136.                 >TECO
  137.                 *EWfilespec1$
  138.  
  139. MUNG.BAT
  140.  
  141.      If you type
  142.  
  143.                >MUNG filespec1 a long text string with fewer than 9 spaces
  144.  
  145. this is equivalent to
  146.  
  147.                >TECO
  148.                *Ia long text string with fewer than 9 spaces$EIfilespec1$$
  149.  
  150. and I will leave it to your imagination on how to use this. (BTW, MUNG is an
  151. acronym for Mung Until No Good which is what will happen if your .TEC file
  152. isn't perfect).
  153.  
  154. If you don't wish to use the batch files you may get the same result with:
  155.  
  156.               >TECO make filespec1
  157.               or
  158.               >TECO mung filespec1 any spaced string
  159.  
  160. but make and mung in these must be lower case. You may rename MAKE.BAT and
  161. MUNG.BAT to anything you like (incase, e.g., you are using MAKE for something
  162. else) or modify them to point to appropriate directories.
  163.  
  164. I put MUNG.BAT and MAKE.BAT in my \BATCH directory which is also in the path.
  165.  
  166.                      INITIAL SETUP AND TECO.INI FILE
  167.  
  168.         PCTECO has a special flag (EZ) not found in other incarnations of
  169.         TECO. The purpose of this flag is to allow setting of certain
  170.         MSDOS characteristics such as text color and display mode. (See
  171.         FLAGS.DOC for a complete description). The supplied TECO.INI file
  172.         sets this flag to suit my tastes. If you don't want these settings
  173.         put TECO.INI where TECO can't find it or change it to your liking.
  174.  
  175.  
  176.                          THE PC KEYBOARD MACROS
  177.  
  178.     The following keyboard macros are explained in terms of their
  179.     effective TECO action.
  180.  
  181. [DArr] or
  182. [LF](^J) - LT
  183.  
  184. [UArr] or
  185. [BS](^H) - -LT
  186.  
  187. [PgDn]   - nTnL (where n is number of lines on your screen-1)
  188.  
  189. [PgUp]   - -nLnT (see above for n)
  190.  
  191. ^[Home]  - J^A[^A.:=^A]^M^J^A (goes to beginning of text buffer and
  192.            verifies we're at beginning [0])
  193.  
  194. ^[End]   - ZJ^A[^A.:=^A]^M^J^A (goes to end of text buffer and prints number
  195.            of chars in text buffer)
  196.  
  197. [Home]   - 0L
  198.  
  199. [End]    - L-2C
  200.  
  201. [RArr]   - C
  202.  
  203. [LArr]   - -C
  204.  
  205. ^[RArr]  - S^N^S$S^S$-S^N^S (goto end of next 'word', ES off)
  206.  
  207. ^[LArr]  - -S^S$-S^N^S (goto end of previous 'word', ES off)
  208.  
  209. [DEL]    - D
  210.  
  211.  
  212.     NB: These macros are most useful with the EV and ES flag set so that you
  213.     can see the effect of the action. If you don't wish to use these
  214.     immediates it would be best if you turned off ev and es (0es0ev). The
  215.     supplied init file (TECO.INI) makes EV show the tilde and the ES show
  216.     the pipe/or symbol.
  217.  
  218.     Also note that these macros are spliced into the current command
  219.     string (except [BS] and [LF]) so that constructs like e.g., j[PgDn]
  220.     will work. These macros have a double escape at the end so they will
  221.     only work at the end of a command string.
  222.  
  223.  
  224.  
  225.                             FUNCTION KEYS
  226.  
  227.     You can define your own keyboard macros by loading the Q-registers.
  228.     The function keys (F1 - F10) now execute macros stored in Q-registers
  229.     1-9,0, respectively. To use simply load your macros in the desired
  230.     Q-register either manually or through an indirect file. When a function
  231.     key is pressed TECO executes Mq$$ where q is in [0..9]. The supplied
  232.     init file TECO.INI loads Q-register 1 with a macro to give dir *.*
  233.     each time F1 is pressed.
  234.  
  235.  
  236. Well, this should get you started. I hope you have as much fun playing with
  237. the real, infamous, old and dangerous TECO again as I have had! It has
  238. all the features and all the dangers of the *original*.
  239.  
  240. Of course, it goes without saying that if you trash your entire system
  241. by a single misplaced keystroke there will be no whining. This IS TECO
  242. afterall.
  243.  
  244. BTW, don't forget the ? command. If you get an error message type ?
  245. immediately to see where in the command the problem occured. Also you
  246. can preceed any command or macro with a ? which activates the trace
  247. feature and can be quite helpful at times (and quite confusing at others).
  248.  
  249. Have Fun!
  250.  
  251. north@nosc.mil
  252.  
  253. Mark H. North
  254. 1826 Galveston St.
  255. San Diego, CA 92110
  256.  
  257. Res: 619-275-3465            5pm to 7am PT
  258. Ofc: 619-553-6761            8am to 4pm PT
  259.  
  260.  
  261. If a catastrophic catastrophy occurs this version of TECO is programmed to
  262. remove all references to my identity from your disk and insert the current
  263. address of DECUS. 8^)
  264.  
  265. No warrantees expressed or implied, etc blah blah.
  266.  
  267. This is FREEWARE. Although I retain the copyright you may use or give away
  268. PCTECO. However, you may not sell it nor include it in any package for sale.
  269.